feat(backend): add goals module with CRUD, progress tracking, and com… - #1134

Closes #1021, Closes #1022, Closes #1023, Closes #1025

Overview

This PR implements the complete goals feature set within the real-time off-chain backend for Stellar Tipz (backend/src/modules/goals/). Target PR base branch: test-implement-drips.

The changes add secure CRUD operations for creator goals, automatic real-time progress calculations based on incoming tips, automatic goal completion detection with notification triggers, and comprehensive OpenAPI/Swagger documentation for all goals endpoints.

Feature Summary

• Goals CRUD Module: Implemented REST endpoints for creating, reading, updating, and soft-deleting/archiving creator goals with authentication and authorization checks.
• Dynamic Goal Progress Calculation: Developed real-time progress aggregation logic that calculates current vs. target amounts based on confirmed tips and contribution transactions.
• Completion Detection & Notifications: Added event-driven monitors to automatically detect when a goal threshold is met/exceeded and fire completion notification events to the notification service.
• API Documentation: Added OpenAPI/Swagger annotations and schemas covering all goal routes, payloads, parameters, and response structures.

Technical Implementation

• backend/src/modules/goals/goals.controller.ts: Defined routes for goals CRUD, progress lookups, and manual adjustments, protected by JWT authentication and owner authorization guards.
• backend/src/modules/goals/goals.service.ts: Implemented business logic for goal lifecycle management, tip calculation aggregations, percentage completion computations, and idempotent state transitions upon goal completion.
• backend/src/modules/goals/goals.listener.ts / Event Bus: Subscribed to incoming tip events to automatically update goal progress, check completion thresholds, and dispatch goal completion notification triggers.
• backend/src/modules/goals/dto/: Created validated request DTOs (create-goal.dto.ts, update-goal.dto.ts) with class-validator decorators and OpenAPI properties.

Test Coverage

• Unit Tests: Verified goal state management, calculation accuracy across edge cases (0% progress, overflow past 100%, multi-currency handling), and guard authorizations.
• Integration Tests: Tested end-to-end HTTP endpoints for CRUD routes, event-driven progress updates upon tip insertion, and completion notification dispatches.
• Quality Checks: Verified npm run typecheck, npm run lint, and npm run test all execute successfully with zero errors or warnings.

Checklists

• Implemented secure, authorized CRUD endpoints for goals
• Integrated automated progress calculation logic tied to tip events
• Added automated goal completion detection and notification dispatching
• Documented all endpoints and schemas via Swagger/OpenAPI annotations
• Verified full test suite, TypeScript typecheck, and linter pass cleanly